home *** CD-ROM | disk | FTP | other *** search
/ Amiga Magazin: Amiga-CD 1997 November & December / Amiga-CD 1997 #11-12.iso / pd-disketten / ungepackt / 12_95 / apd-12-95-4-2 / superprint / superprint.dok < prev    next >
Text File  |  1996-01-25  |  19KB  |  473 lines
  1.  
  2.                               SuperPrint
  3.                              ------------
  4.  
  5.  
  6.                        DAS LUXUS DRUCK-UTILITY
  7.  
  8.                     Beschreibung zur Version 3.5b
  9.  
  10.                             17. Juni 1994
  11.  
  12.                              PD-Giftware
  13.  
  14.  
  15.                    (deutsche und englische Version)
  16.  
  17.  
  18. ----------------------------------------------------------------------
  19. -- Zum Betrieb von SuperPrint ist mindestens OS-2.04 Voraussetzung! --
  20. --          Das Programm läuft ebenfalls unter OS-3.0 ;-)           --
  21. ----------------------------------------------------------------------
  22.  
  23.  
  24.                          SUPERPRINT Beschreibung
  25.                         -------------------------
  26.  
  27. SuperPrint ist ein Hilfsprogramm, um einem die Arbeit beim Ausdrucken
  28. von Dokumenten oder Quellcodes (in ASCII) zu erleichtern.
  29.  
  30. Sicher, man kann dies auch z.B. mit dem DOS-Befehl TYPE erledigen,
  31. aber kann dieser
  32.  
  33.  - die Seiten durchnumerieren,
  34.  
  35.  - die Ränder frei wählen,
  36.  
  37.  - überlange Zeilen anpassen,
  38.  
  39.  - eigene Texte auf jeder Seite ausgeben,
  40.  
  41.  - Kopf- und Fußzeilen frei verwalten,
  42.  
  43.  - Ein Inhaltverzeichnis erstellen ?
  44.  
  45. Jein!!
  46.  
  47. Die Ränder lassen sich gewiß übers Preference einstellen, das war es
  48. aber auch schon!
  49.  
  50. Hauptauslöser für meine Arbeit war jedoch, daß ich die Beschreibung
  51. von "Term" ausdrucken wollte und in meiner PD Sammlung irgendein
  52. Druckteil fand.
  53.  
  54. Da die Beschreibung von Term aber so lang ist, habe ich nicht bemerkt,
  55. daß es Zeilen mit Überlänge gibt. Ergebnis: Das Seitenlayout (Kopf-
  56. und Fußzeilen) war völlig zerstört, da dies von diesem Druckteil nicht
  57. beachtet wurde.
  58. (Deshalb hier mein Aufruf an alle Programmierer und Dokus-Schreiber:
  59. bitte, machte eure Texte nicht länger als 70 Zeichen/Zeile, niemals
  60. jedoch länger als 78 Zeichen/Zeile! - dieses neue DOK-File hält sich
  61. jetzt auch daran)
  62.  
  63. Also schrieb ich meine eigene Fassung, Intuition-Oberfläche, OS-2.0-
  64. Funktionen, die ich jetzt beschreiben will (oder besser muß, da ich
  65. weiß, wie alles funktioniert).
  66.  
  67. Neu seit Version 3.0 ist des automatische Inhalsverzeichnis. Dazu muß
  68. allerdings zu jeder Beschreibung ein weiteres File existieren, in dem
  69. alle Überschriften stehen, die im Inhaltsverzeichnis stehen sollen.
  70. Eine genaue Beschreibung dieses Files folgt später.
  71.  
  72.  
  73. Nach dem Programmstart erscheint kurz ein Info-Fenster, das, nachdem
  74. das Programm initialisiert wurde, durch ein Arbeitsoberfläche ersetzt
  75. wird.
  76.  
  77.  
  78.                          Die Arbeitsoberfäche
  79.                         ----------------------
  80.  
  81. Es erscheinen verschiedene Gadgets (Buttons, String, Cycle):
  82.  
  83. FILENAME ...... Es erscheint ein ASL-Filerequester, mit dem das zu
  84.                 druckende File gewählt werden kann.
  85.                 Im String-Gadget hinder dem Schalter kann der Name von
  86.                 Hand bearbeitet werden.
  87.                 Wird ein Inhaltsverzeichnis-Indexfile gefunden (später
  88.                 mehr), wird dies über einen Requester mitgeteilt und
  89.                 man kann wählen, ob dieses beachtet werden soll.
  90.                 (was sinnvoll ist, aber dann einen Moment dauern kann)
  91.                 Das selbe kann auch erreicht werden, wenn man einfach
  92.                 das Icon des zu druckendes Files über das SuperPrint-
  93.                 Fenster legt.
  94.  
  95. SCAN FILE ..... Diese Funktion überprüft die gewählte Datei auf die
  96.                 maximale Zeilenlänge und die bei diesen Einstellungen
  97.                 benötigten Seiten, die dann hinter dem Schalter
  98.                 gezeigt werden. Wurde im Optionen-Fenster (siehe
  99.                 unten) die Funktion Scan-Info aktiviert, erscheint
  100.                 nach dem Scannen ein Informationsfenster, das Auskunft
  101.                 über Seitenumbrüche (Formfeeds) in der Datei, die
  102.                 allgemeine Zeilenlänge und mehr gibt.
  103.  
  104. LINKER RAND ... Hier kann die Anzahl der Leer-Zeichen eingegeben
  105.                 werden, die zwischen dem linken Papierrand und dem 
  106.                 Start des Textes liegen soll.
  107.  
  108. RECHTER RAND .. Gibt die Zeichenposition an, ab der der Text enden 
  109.                 soll. Die sich aus den Rändern ergebende tatsächliche 
  110.                 Breite einer Textzeile steht hinter dem Text 
  111.                 "Zeichen/Zeile".
  112.  
  113. ZEILEN/SEITE .. Gibt die Anzahl der maximal möglichen Zeilen auf einer
  114.                 an.
  115.  
  116. <- PREFS ...... Über diese 3 Schalter jeweils hinter den oben 
  117.                 genannten 3 Eingabefeldern kann der Wert, hinter dem 
  118.                 sie stehen, auf den über die System-Preferences
  119.                 eingestellten Wert gesetzt werden. (Klar ? Z.B. kann 
  120.                 der linke Rand auf den Wert der Preferences gesetzt 
  121.                 werden.)
  122.  
  123. DAVON KOPF .... gibt an, wieviele Zeilen der Kopf umfassen soll (von 
  124.                 der ZEILEN/SEITE-Zahl)
  125.  
  126. FUß ........... oder besser DAVON FUß, gibt an, wie groß der 
  127.                 Fußbereich der Seiten ist (wie beim Kopf)
  128.  
  129. EXTRA-TEXT .... hier kann ein Text eingegeben werden, der auf jeder 
  130.                 Seite im Kopf oder Fuß erscheinen soll (siehe unten)
  131.  
  132. KOPF-ZEILEN ... Mit dem vorderen Cycle-Gadget kann der Text-Stil in 
  133.                 der Kopfzeile gewählt werden (normal, fett oder
  134.                 kursiv).
  135.                 Mit dem hinteren Cycle-Gadget wird dann bestimmt, was
  136.                 überhaupt in der/den Kopfzeile/n stehen soll: nichts 
  137.                 ("leer"), die Seitenzahl oder der EXTRA-TEXT.
  138.                 Dazu sollte der Kopf jedoch mindestens eine Zeile groß
  139.                 sein.
  140.  
  141. FUß_ZEILEN .... Die Cycle-Gadgets haben die selben Funktionen wie bei
  142.                 KOPF-ZEILEN, beziehen sich jedoch auf die - nah' was 
  143.                 wohl - Fuß-Zeilen - genau!!
  144.  
  145. DRUCKEN ....... Startet den Ausdruck. Es erscheint ein kleines 
  146.                 Kontroll-Fenster, das den aktuellen Stand der Dinge 
  147.                 (wir weit der Druckvorgang ist) und eine
  148.                 Abbruchmöglichkeit bietet.
  149.                 Eventuelle Fehler werden über Systemrequester 
  150.                 angezeigt.
  151.                 Soll ein Inhaltverzeichnis erzeugt werden, dann wird
  152.                 das File vorher gescannt, weshalb zwei mal ein
  153.                 Kontroll-Fenster erscheint, das erste jedoch ohne
  154.                 Abbruchmöglichkeit.
  155.  
  156. OPTIONEN ...... öffent ein weiteres Fenster mit neuen Einstell- 
  157.                 möglichkeiten
  158.                 (siehe unten)
  159.  
  160. PROGRAMM INFO . zeigt eine Information zum Programm.
  161.  
  162. ENDE .......... um es kurz zu sagen, es wird, ohne Vorwarung und ohne 
  163.                 sich etwas zu merken (bis auf gespeichertes im
  164.                 OPTIONEN-Fenster) die selbe Funkion ausgeführt, wie 
  165.                 über das Close-Gadget des Fensters: das Programm wird 
  166.                 beendet!! (Natürlich ist diese Funktion absoluter
  167.                 Schwachsinn, aber die Commodore-Konvertionen verlangen
  168.                 nunmal eine Programmende)
  169.  
  170.  
  171. Werte hinter den Texten
  172.  
  173. SEITEN ............. Anzahl der Seiten des gewählten Files (nach dem 
  174.                      Aufruf der Scan-Funktion gültig)
  175.  
  176. MAX. ZEICHEN/ZEILE . Höchstzahl der Zeichen pro Zeile im gewählten 
  177.                      File (ebenfalls nach Scan-Funktion gültig)
  178.  
  179. ZEICHEN/ZEILE ...... Zeichen, die bei den gewählten Rändern und 
  180.                      Zeichendichte pro Zeile zur Verfügung stehen.
  181.  
  182. ZEILEN/SEITE ....... zeigt die Anzahl der vom Text nutzbaren Zeilen,
  183.                      also die Zeilen, die zwischen Kopf und Fuß einer
  184.                      Seite liegen
  185.  
  186.  
  187.                          Das OPTIONEN-Fenster
  188.                         ----------------------
  189.  
  190. Hier können nicht so oft benötigte Funktionen eingestellt werden. Fast
  191. alle Funktionen werden über CYCLE-Gadgets (vgl. Handbuch) bedient.
  192.  
  193.  
  194. ÜBERLÄNGEN .... Wenn der Text einer Zeile länger ist als die Ränder es
  195.                 erlauben, kann hier gewählt werden, was mit den
  196.                 restlichen Zeichen geschehen soll. Sie können
  197.                 abgeschnitten oder aufgeteilt werden, oder es wird
  198.                 einfach gedruckt, wodurch jedoch das Layout stark
  199.                 gestört werden kann!
  200.  
  201. SEITENUMBRUCH . Manche Texte sind bereits mit Formfeed (Seitenumbruch)
  202.                 versehen. Gewiß eine feine Sache, wenn die Schreiber
  203.                 auch auf die Ränder geachtet haben. Aber deshalb gibt
  204.                 es SuperPrint und diese Funktion, um vorhandene
  205.                 Formfeed zu ignorieren ("entfernen") oder zu
  206.                 "beachten". Ignorieren ist dann sinn- voll, wenn ein
  207.                 File FFs enthält, jedoch diese nicht günstig
  208.                 verteilt sind (z.B. wegen Extra-Texten, also wegen
  209.                 Kopf- und Fußzeilen).
  210.  
  211. ZEICHEN/ZOLL .. Falls ein File wirklich lange Zeilen enthält (über 80
  212.                 Zeichen pro Zeile) und diese benötigt werden, jedoch 
  213.                 ein "drauflosdrucken" alles zerstören würde, kann mit 
  214.                 diesem Schalter auf eine höhere Zeichendichte 
  215.                 geschaltet werden.
  216.  
  217. QUALITÄT ...... Ermöglicht die Wahl der Druckqualität: Schönschrift 
  218.                 oder Schnellschrift.
  219.  
  220. SEITENTEXT .... Ermöglicht die Platzierung der Seitennummer: links, 
  221.                 mitte, rechts
  222.  
  223. TEXT (%n - NR)  Hier kann der Text der Seitennummer eingegeben werden.
  224.                 "%N" ist dabei der Platzhalter für die Nummer.
  225.  
  226. SCAN INFO ..... Ermöglicht das Ein- und Ausschalten der
  227.                 Zusatzfunktionen beim Filescannen. Diese zeigt nach
  228.                 einem Scan nähere Infos an, z.B. ob FFs vorhanden sind
  229.                 und wie lang die Seiten dann sind.
  230.  
  231. DRUCKE ........ Dies ermöglicht einen mehrseitigen Ausdruck, dazu
  232.                 können zuerst alle ungeraden und dann alle geraden
  233.                 Seiten gedruckt werden - oder es werden eben normal
  234.                 alle Seiten gedruckt.
  235.  
  236. SICHERN ....... speicher diese Einstellungen (und die des 
  237.                 Hauptfensters!) in der Datei "SP.config" im 
  238.                 Verzeichnis von SuperPrint.
  239.                 Diese wird bei jedem Programmstart dann gelesen.
  240.                 Anschließend wird zum Hauptfenster zurückgekehrt.
  241.  
  242. BENUTZEN ...... Kehrt zum Hauptfenster zurück, die Einstellungen 
  243.                 werden übernommen.
  244.  
  245. ABBRECHEN ..... Kehrt ebenfalls zum Hauptfenster zurück, es werden
  246.                 jedoch die Einstellungen von vor dem OPTIONEN-Aufruf 
  247.                 wieder hergestellt.
  248.  
  249.  
  250.                                Internes
  251.                               ----------
  252.  
  253. Alle Steuercodes im zu druckenden Text werden übernommen, außer dem
  254. Formfeed, der, je nach Einstellung, übergangen oder intern bearbeitet:
  255. Es wird die aktuelle Seite beendet, der Fuß ausgegeben und eine neue
  256. Seite begonnen.
  257.  
  258. Die Ränder werden IMMER in Zeichen der Breite 10 cpi gemessen,
  259. ebenfalls werden Zusatztext und Seitenzahl in dieser Zeichendichte
  260. gedruckt.
  261.  
  262. Seit Version 3.5 wird der Screen-Font des jeweiligen
  263. (Default)PublicScreens für die Textausgabe (Gadgets, etc.) benutzt.
  264. Sollte der Screen jedoch zu klein sein, um alle Gadgets aufnehmen zu
  265. können, fällt das Programm AUTOMATISCH auf 8 zurück (wo es immer
  266. paßt).
  267.  
  268.  
  269.                      Inhaltsverzeichnis erzeugen
  270.                     -----------------------------
  271.  
  272. Mit der Version 3.0 kann zu jeder Beschreibung ein Inhaltsverzeichnis
  273. erzeugt werden. Dazu muß zu jeder Doku ein weiteres File vorhanden
  274. sein, das den selben Namen plus dem Suffix ".sprint" trägt. In diesem
  275. File stehen jetzt alle Überschriften, die im Inhaltsverzeichnis stehen
  276. sollen, sowie noch weitere SuperPrint Einstellungen.
  277.  
  278. Dazu habe ich folgende Schlüsselworte eingeführt:
  279.  
  280. LEFT=       - setzt den linken Rand wie über das Gadget
  281. RIGHT=      - dito. für den rechten Rand
  282. LINES=      - dito. für die Zeilen pro Seite
  283. HEAD=       - dito. für die Anzahl der Kopfzeilen
  284. FOOT=       - dito. für die Fußzeilen
  285. HEADMODE=   - wählt den Text für die Kopfzeilen (0 - leer,
  286.                                                  1 - Seitenzahl,
  287.                                                  2 - Extra-Text)
  288. FOOTMODE=   - dito. für die Fußzeilen
  289. HEADSTYLE=  - wählt den Stil der Kopfzeilen-Texte (0 - normal,
  290.                                                    1 - halbfett,
  291.                                                    2 - kursiv)
  292. FOOTSTYLE=  - dito. für die Fußzeilen
  293. TEXT=       - setzt den Extra-Text
  294. CPI=        - setzt die Zeichendichte (0 - 10 CPI,
  295.                                        1 - 12 CPI,
  296.                                        2 - 17 CPI)
  297. PAGE=       - setzt den Seiten-Text ("Seite: %N"),
  298.               dabei steht %N als Platzhalter für die Seitenzahl
  299.               und MUSS vorhanden sein
  300. PAGEPOS=    - setzt die Position des Seiten-Text (0 - links,
  301.                                                   1 - mittig,
  302.                                                   2 - rechts)
  303. ONE=        - die Anzahl an Zeilen, die hier angegeben wird, wird
  304.               VOR dem Inhalsverzeichnis gedruckt und dann eine neue
  305.               Seite begonnen
  306.  
  307. INDEXHEAD=  - der hier angegebene Text wird auf die erste Seite des
  308.               Inhaltsverzeichnis gedruckt
  309.  
  310. STYLE=      - bestimmt das Aussehen der Überschriften, es werden z.Z.
  311.               die Parameter BOLD für Fettdruck und LEFT für das
  312.               Einrücken der Überschrift ein Zeichen nach links
  313.               unterstützt
  314.  
  315. @x=         - Hinter dieses Zeichen werden jeweils die Überschriften
  316.               eingegeben, dabei steht x für eine weitere Bestimmung
  317.               des Textes: 0 - Text stimmt mit Dok-File überein
  318.                           1 - es handelt sich um den Anfang einer
  319.                               Überschrift
  320.                           2 - wie 1, nur wird der Text aus dem Dok-
  321.                               File übernommen
  322.  
  323. NOSORT      - Schaltet die alphabetische Sortierung der Überschriften
  324.               ab. Es wird dann nach Seitennummern sortiert.
  325.  
  326.  
  327. Als Beispiel liegt zu dieser Beschreibung ein ".SPRINT"-File bei.
  328.  
  329.  
  330.                                 Aufruf
  331.                                --------
  332.  
  333. Ich bitte alle Programm- bzw. Textautoren ihren Beschreibungen doch
  334. ein ".sprint"-File beizulegen. Die Herstellung ist schnell gemacht und
  335. fördert die Übersichtlichkeit der Ausdrucke. Des weiteres sollten
  336. keine Dokumentationen längere Zeilen aus 70 Zeichen enthalten, da so
  337. kein Text abgeschnitten wird bzw. der Ausdruck verstört wird!
  338.  
  339. Im Namen aller Anwender bedanke ich mich bei Euch und als
  340. Programmierer werde ich mich an diese Regel halten.
  341.  
  342.  
  343.                          Copyright, der Autor
  344.                         ----------------------
  345.  
  346. Ich finde, das Programm ist eine gelungene Sache, frei von jeglichen
  347. Rechten ist es zwar nicht, da manche Routinen und Prozeduren in diesem
  348. Programm auch in anderen Programmen von mir vorkommen, die kein Public
  349. Domain sind.
  350.  
  351. Da es jedoch meine eigene Prozeduren sind ist dies wohl belanglos!
  352. Sie unterliegen jedoch dem (c) copyright von J.Schmitz [SOFT].
  353.  
  354. Das Programm ist seit Version 2.4 PD-Giftware, darf also frei kopiert
  355. und benutzt werden. Sollte Dir das Programm gefallen und Du benutzt es
  356. öfters, so wäre ich Dir für eine kleine Spende dankbar (so um
  357. DM 10,--).
  358. Wer sich das nicht leisten kann, ich spreche als Ex-Schüler da aus
  359. Erfahrung, sollte mir trotzdem ruhig einen kleinen Brief schicken
  360. (auch mit Programm-Ideen oder Änderungsvorschlägen). Dies dann per
  361. Post oder auch ruhig per FIDO-NetMail erfolgen.
  362.  
  363. Wer jedoch will, darf mir statt Geld auch Disketten, eigene Progs,
  364. gute Grafiken, Samples oder Musikstücke schicken.
  365.  
  366. Da ich mir einen A4000 zugelegt habe und meine Kasse jetzt so ziemlich
  367. leer ist, bin ich für JEDE Spende dankbar, seien es nur A4000-Tip,
  368. Progs, oder so.
  369. (Natürlich solltet Ihr die Kartoffelsäcke, Blumenerde und ähnliches
  370. besser anderen Leuten schicken!)
  371.  
  372. Die Verbreitung des Programms auf PD-Disketten (-Serien) und per DFÜ
  373. ist erlaubt bzw. erwünscht.
  374.  
  375. Der  Preis der PD-Diskette darf jedoch nicht über DM 6.-- liegen!! Wer
  376. das  Programm  auf  eine  PD Diskette kopiert muß dem Autor eine Kopie
  377. dieser  zuschicken. 
  378.  
  379.  
  380.  
  381.                          Meine Post-Adresse:
  382.  
  383.  
  384.                             Jürgen Schmitz
  385.                                  "PD"
  386.                             Bergstraße 82
  387.  
  388.                          D-56859 Bullay/Mosel
  389.  
  390.  
  391.                                oder im
  392.                       
  393.                  FIDO:  Juergen Schmitz, 2:2454/550.3
  394.  
  395.                AMIGA-NET: Juergen Schmitz, 39:176/401.2
  396.  
  397.  
  398. Fast hätte ich es vergessen, aber der folgende Text muß sein, da das
  399. Programm sonst nich frei von Rechten wäre:
  400.  
  401. Geschrieben mit KICK-Pascal 2.0 von MAXON-Computer GmbH.
  402.  
  403. Und jetzt - gut druck...
  404.  
  405. ----------------------------------------------------------------------
  406.  Programmgeschichte SuperPrint:
  407. ----------------------------------------------------------------------
  408.  
  409. Version 3.5b: Fenster öffnen beim Start geändert
  410.  
  411. Version 3.5: Oberfläche Fontsensitiv (dank "Barney")
  412.  
  413. Version 3.4: BugFixes, Adresse geändert
  414.  
  415. Version 3.3: Fehler bei Ausgabe des Inhaltsverzeichnis entfernt
  416.              
  417. Version 3.2: Neue Überlängenverarbeitung, gerade und ungerade Seiten
  418.              getrennt druckbar - NEUES OPTIONEN-FILE FORMAT!
  419.  
  420. Version 3.1.5: Befehl STYLE für Inhaltsverzeichnis neu (bzw. jetzt mit
  421.                Parametern)
  422.  
  423. Version 3.1: Inhaltsverzeichnis nicht mehr zwingend alphabetisch
  424.  
  425. Version 3.0: Inhaltsverzeichnis-Generator eingebaut,
  426.              AmigaGuide-File entfernt (mir gefällt sowas also Doku
  427.              nicht)
  428.  
  429. Version 2.4: Fehler entfernt (Fuß auf letzter Seite wurde im falschen
  430.              Schrift-Stil gedruckt, da Ein- u. Aus-ESC-Code
  431.              vertauscht)
  432.              Texte verbessert, jetzt ist SuperPrint GIFTWARE.
  433.              SuperPrint benutzt jetzt den System-Default-Font, wenn es
  434.              der Screen erlaubt. Ist er zu klein wird auf Topaz 9 oder
  435.              Topaz 8 zurückgeschaltet (je nach Platz).
  436.  
  437. Version 2.3b: Fehler in der in V2.3 geänderten Druckfunktion entfernt
  438.               (Zeilen >80 Zeichen wurden immer abgeschnitten),
  439.               Hinweis-Texte bei SCAN-Funktion berichtigt und ergänzt.
  440.  
  441. Version 2.3: Scan-Funktion eingebaut, "Zeilen/Seite" Feld hinzugefügt,
  442.              englisches Doc-File entfernt, da veraltet und keine Zeit
  443.              und Ahnung für neues -> ACHTUNG: wer will darf dieses Dok
  444.              ins Englische übersetzen und sich dort verewigen - bitte
  445.              mir dann eine Mail UND die Übersetzung schicken, danke!
  446.              AmigaGuide-File erstellt.
  447.  
  448. Version 2.2: neue Funktione - Options-Fenster für weitere
  449.              Einstellungen, speicherbar, Verarbeitung der Ränder
  450.              geändert
  451.  
  452. Version 2.1: beta-Version zur Version 2.2
  453.  
  454. Version 2.0: jetzt endlich WB-AppWindow, d.h. File-Icons können in das
  455.              Fenster gelegt werden
  456.  
  457. Version 1.9: Fehler entfernt, SCAN-FILE Funktion jetzt mit Abbruch
  458.  
  459. Version 1.8: neue Funktion SCAN FILE, Optik deshalb leicht geändert,
  460.              intern bessere Verarbeitung von ESC-Codes
  461.  
  462. Version 1.7: keine Funktionsänderungen, aber jetzt auch in englisch
  463.  
  464. Version 1.6: 1. öffentliche Fassung, nur in deutsch
  465. ----------------------------------------------------------------------
  466.  
  467. Englische Beschreibung von Matthias Wege.
  468.  
  469. Danke!
  470.  
  471.  
  472. JS/06
  473.